---
title: STRLEN
description: Redis STRLEN 命令用于获取指定键的字符串值长度。
sidebar:
  order: 6
---

import { Code } from '@astrojs/starlight/components'

返回 key 所储存的字符串值的长度。

当 key 储存的不是字符串值时，返回一个错误。

### Redis 原生命令语法

<Code code={`STRLEN key`} lang="bash" />

**参数说明**

- **key**: 要获取长度的键

### 详细说明

STRLEN 命令用于获取存储在指定键中的字符串值的长度。对于不存在的键，命令返回 0。

## Redisun 使用方式

在 redisun 中，STRLEN 命令通过 StrlenCommand 类和 Redisun 类中的 strlen 方法实现。

### 基本用法

<Code code={`Redisun redisun = Redisun.create(options -> {
    options.setAddress("redis://127.0.0.1:6379");
});

// 设置一个字符串值
redisun.set("mykey", "Hello World");

// 获取字符串长度
int length = redisun.strlen("mykey");
System.out.println("String length: " + length); // 输出: 11

// 对不存在的键获取长度
length = redisun.strlen("nonexistent");
System.out.println("Non-existent key length: " + length); // 输出: 0

// 异步版本
CompletableFuture<Integer> future = redisun.asyncStrlen("mykey");
future.thenAccept(len -> System.out.println("Async length: " + len));`} lang="java" />

## 注意事项

1. 对于不存在的键，返回长度为 0
2. 如果 key 存在但不是字符串类型，会抛出异常
3. 空字符串的长度为 0

## 参考资料

- [Redis STRLEN 命令官方文档](https://redis.io/commands/strlen/)